The Atari Compendium

home *** CD-ROM | disk | FTP | other *** search

/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / telecomm / ansi190.lzh / ANSI190.DOC < prev next >

Wrap

Text File | 1992-03-28 | 20.3 KB | 434 lines

ANSITerm By Timothy Miller Version 1.9 Two Worlds Software Documentation by Timothy Miller & Sean Dougherty (c) Copyright July, 1992 Timothy Miller, Two Worlds Software NO PORTION OF THIS PROGRAM MAY BE MODIFIED, DISASSEMBLED, DECODED, OR REMOVED BY ANY MEANS WITHOUT PRIOR PERMISSION OF THE AUTHOR. NO PORTION OF THIS PROGRAM MAY BE USED IN ANY OTHER PROGRAM. THE ABOVE ALSO APPLIES TO THE FONT FILE INCLUDED WITH ANSITERM. ALL OTHER RIGHTS RESERVED. THE USER IS AUTHORIZED TO USE THE PROGRAM ANSITERM. HE HAS PERMISSION TO DISTRIBUTE THIS PROGRAM, AT NO COST. NO PROFIT MAY BE DERIVED OUT OF THE SALE OF THIS PROGRAM WITHOUT THE SPECIFIC PERMISSION OF THE AUTHOR. THE USER IS PERMITTED TO USE THE ANSITERM PROGRAM FOR A TRIAL PERIOD OF THIRTY DAYS, AFTER WHICH TIME, THE USER MUST SEND THE $15 REGISTRATION FEE TO THE ADDRESS LISTED BELOW. IF, AFTER THIRTY DAYS, THE USER HAS NOT REGISTERED ANSITERM, ANSITERM MUST BE REMOVED FROM HIS COMPUTER SYSTEM. PIRACY IS NOW A FELONY! The author, Timothy Miller, can be contacted as: Timothy Miller - Excalibur II BBS (813)988-2603 Timothy Miller - Flea Infested BBS (813)989-8564 T.MILLER23 - GEnie tmiller@suntan.ec.usf.edu - Internet millert@eggo.csee.usf.edu - Internet The following files are part of the ANSITerm package: ANSI190.PRG ANSI190.DOC FONT48.DAT These files MUST be included. All other files are optional, except XYZ which is necessary for file transfers. ANSITerm's Features (* = New to version 1.5B, % = Updates for v. 1.8) (& = Updates for v. 1.9) - ANSITerm is a 100% ANSI VT-102 compatible terminal program that supports full 16 colors, blinking text, with 80 columns. - Supports X-modem, Y-modem, and Z-modem transfers (using XYZ.TTP) - Full mouse support and menu bars - AutoDialer with separate options (line-feeds, local echo, etc.) for every entry. * Capture buffer with the ability to send and print selected blocks * Selectable color palettes * New intelligent memory saving techniques * View Buffer and block functions * Auto Z-modem Download and Upload * Ten 79-character global macros * Upload/Download paths can be set along with the path of XYZ.TTP % Better compatibility with Warp 9 % "Can't find XYZ.TTP" bug fixed. % Properly supports VT-100 tabs % Supports Y-modem G with Alan Hamilton's XYZ 2.02 % Buffer viewer now has PRIMITIVE editing capabilities and displays text 4 times faster % 57600 bps MIGHT work on an Atari TT % Terminal displays text at least 2 times faster & ANSITerm now supports underlined text & Type-ahead buffer now takes up the entire width of the top line & Buffer editor Delete Block bug fixed. & An escape character can now be typed into the editor (HELP key) & Character for <CR> (#13) in font has been changed to something meaningful. Character for <LF> (#10) has been shifted right by one pixel so it doesn't jam up against the new <CR>. & The dialer will now properly dial all 14 telephone number digits. NOTE: The filename of the dialer and options file that is loaded when you run the ANSI190.PRG program is STILL "ANSIDIAL.15B". NOTE ALSO: When going to a file selector, ANSITerm will sometimes appear to lock up. Just try hitting a few mouse buttons and the file selector should appear. A similar situation occurs sometimes when exiting ANSITerm. ShareWare Info This program is shareware and I have put much time into making this into the best terminal program possible. If you use and like this program, please support the author and allow him to make future upgrades by sending a $15 donation or more to: Timothy Miller 7519 Winging Way Drive Tampa, FL 33615-1519 U.S.A. Please make checks payable to Timothy Miller. All users in the U.S.A. who register CAN REQUEST free updates by mail. File Transfers File transfers can be accomplished through the use of Alan Hamilton's XYZ file transfer program. I have found no way to keep the program in memory and call it when needed, so ANSITerm must load it each time you transfer a file. For hard-drive users, this is not a problem since ANSITerm remembers where XYZ is, but for floppy disk users, it requires extra effort. ANSITerm will not allow you to swap floppys (load XYZ from one and transfer to/from another) so the use of a RAM disk is recommended for this purpose. You can set ANSITerm to load XYZ from the ramdisk. (With a one floppy system, telling ANSITerm to load XYZ from drive B: may have unpredictable results if ANSITerm is loaded from Medium Res. The alert box may not display right. Try it at your own risk.) Menu Bars To select a menu, click on the title. To make it go away, click on the title again, outside of the window or on another title. Auto DIALer Menu To select a slot that has not been selected, click anywhere on the line except for the field which says DIAL. To insert a one-second pause in any editing fields sent to the modem, press [F10]. This works for all macros. To insert a pause into the phone number, most modems require a comma. |DIAL| If you click on DIAL on any line which has not been tagged for group dial, that slot will immediately be selected, the dialer will go away, and the telephone number listed in that slot will be dialed. If that slot has been tagged for group dial, the dial cycle will begin. |J| (group dial) If you click in the small field between DIAL and the name field of a selected slot, that field will be tagged for group dial. If you click in that field again, the slot will be untagged. |BBS Name | The next field to the right is the name field. Click here to edit. Left and right arrow keys move the edit cursor left and right. Delete removes the character that the cursor is on and moves all characters to the right left to fill in the space. Backspace deletes the character to the left of the cursor and moves all characters at the right of the cursor to fill in the space. |I| Initialize string. This allows a string containing optional modem commands to be sent to the modem before the command to dial is sent. |Phone number| To the right is the phone number field. Click here to edit the phone number as you would for the name field. | Baud| Click here repeatedly until the baud rate you want is displayed. The baud rate numbers have been shortened to provide greater space, and the numbers are the baud rate divided by one hundred. |Options | Each column of this field corresponds directly to an option in the options menu, essentially the same order. They are also listed in the help menu. The meanings of the symbols are listed with the OPTN menu information in this manual and below: W: End of line wrap B: Destructive back space E: Local Echo A: Application mode R: Cursor Application mode N: New line and line feed mode G: IBM Extended Character Graphics Set L: Enable blink ZYKXCG: Transfer protocol Z: Z-modem Y: Y-modem (batch) K: X-modem 1k X: X-modem (standard) C: X-modem checksum G: Y-modem G (for use with error correcting modems) C: Capture enable F: Filter ANSI codes Y: Type-ahead buffer | F1: | F2: | F3: | Macros There are 3 44-character macros for each slot in the dial menu. To edit one, select a slot, and click on the macro you want to edit. Edit as you would for the BBS name. A return character is NOT automatically transmitted at the end of the macro, so you must put one in manually, by pressing the Enter key on the numeric keypad. In fact, any non-printing character (<ESC>, LF, FF, etc.) can be entered into the macro editing field and transmitted as part of the macro. To transmit the macro while on-line, press the function key corresponding to the macro you wish to send. To insert a one-second pause, press F10 in the editing field where the pause is needed. Options (OPTN) Menu End of line wrap With this option off, any character printed at the right most column will overwrite any character at that position without wrapping to the next line. Destructive backspace When this mode is on, if a backspace character is received, the cursor will back up one column and erase any character at that position. If this is not selected, the cursor will back up on column, but not erase any character there. Local Echo When this option is selected, any keys that you press will be automatically displayed on the screen as well as transmitted. (half duplex mode) Application mode If this mode is on, the keys on the numeric keypad will send ANSI escape sequences instead of the characters which appear on the keytops. Cursor key application mode The cursor keys normally send ANSI escape sequences to the modem when pressed. If this option has been selected, a different set of escape sequences will be transmitted by the same keys. New-line and line feed mode If this option is selected, linefeed implies both return and linefeed, and the return key sends both return and linefeed. IBM Extended Character Graphics Set If this mode is on, any characters with a value greater than 127 will cause graphics characters to be displayed. If this mode is off, any such characters will have their most significant bit stripped. This is for boards and on-line services that insist on using set or even parity. Enable blink When this is selected, all characters that have been printed with the blink attribute set will flash on and off at regular intervals. Dial Command When you click on this, you can edit the command that ANSITerm sends to the modem to make it dial. For example, "ATDT" for tone dial, "ATDP" for pulse dial, or "ATDT70#," for tone dial, call waiting off, and the comma for a pause. RTS/CTS Enables RTS/CTS hardware flow control. Most ST users require a fix program for this to operate properly. Dial timeout This allows you to set the number of seconds the cycle dialer waits before skipping to the next board selected for group dial. Click on this line to edit. If a 0 (zero) is entered, NONE is displayed and the cycle dialer will wait until either the modem or the user tells it to skip to the next selected slot. Edit Macros Allows you to edit the 10 global macros. Shift and a function key selects the macro to be edited (RETURN lets you finish editing), and <ESC> lets you exit back to the terminal. To insert a one-second pause into a macro, press the F10 key. To transmit a macro, hold the shift key and press a function key. The Alternate-M key combination also starts the macro editor. Set Loadup Macro When ANSITerm is first booted this macro is sent to the modem, unless the DCD (Carrier Detect) line is high. Quit Selecting this causes ANSITerm to exit to the program which called it (or the GEM Desktop). This can also be selected by pressing the UNDO key. o The OPTN menu will not go away if you select one of the options so you have the chance to select or deselect more than one option before clicking outside of it to remove it from the screen. Select BAUD Menu You can click in this menu to select your baud rate. 38400 bps and 57600 bps are supported, but reliable operation cannot be assumed. FILE Menu Download Loads XYZ from disk (or RAMDISK) to transfer a file. If Z-modem or Y-modem is selected, transfer will start immediately to the folder you select with the Set D/L Path option. If any other protocol is selected, you will immediately get a file selector. This can also be selected with the Alternate-D key combination. Upload Loads XYZ just as Download, but it always gives you a file selector so that you can select the file to be uploaded (or wildcard for Z-modem or Y-modem). This can also be selected with the Alternate-U key combination. Z-modem, etc. Click on one of these to select which protocol you want to use at the moment. As with the OPTN menu, this menu will not go away if you select one of the protocols, so you can immediately select upload or download without having to reselect the menu. Save Dialer/OPTN Saves the contents of the DIAL menu, the default download path, and the Dial timeout to disk. If you are using floppy disks and running XYZ from a RAMDISK, be sure to save to the floppy disk. This also saves the options download/upload path, dial timeout, buffer size, delay timing, dial command, buffer installed/uninstalled status, color palette number, Loadup Macro, baud rate setting, RTS/CTS status, CR/LF filter status, Auto Z-modem selected/deselected, and the ten global macros. Load Dialer/OPTN Loads a dialer from disk and the options with it. ANSITerm can indirectly support more than one dialer menu and set of options this way. Set D/L Path This allows you to pre-set the path to which Z-modem and Y-modem downloads will be saved. Clicking here will give you a file selector. Set U/L Path This allows you to pre-set the path to which uploads will be directed. Clicking here will give you a file selector. Set XYZ Path This is the path of the program, XYZ.TTP, to enable ANSITerm's download and upload options. Auto Z-modem This selection gives ANSITerm the ability to detect Zmodem uploads and downloads independant of XYZ. If either an upload string or download string is detected, ANSITerm immediately runs XYZ if this function is on. Capture Buffer (BUFR) menu If the buffer becomes 75% full, the 'Bufr' menu will change to '75%+'. If, while transmitting the buffer, you suspend sending by pressing Alternate-S, the menu will change to 'Suspnd'. If the buffer fills completely, the menu will change to 'Filled'. Install Buffer Allocates the amount of memory specified by the Bufsize editing field and makes it available for capturing modem input, screen snap-shots, and loading files from disk for transmit or editing. Capture When selected, all characters that come from the modem will be added to the buffer. Filter ANSI In this mode, all ANSI escape sequences are filtered out and only ASCII text may be added to the buffer. Load buffer Clears the buffer and loads the specified file into it. Save buffer Saves the current contents of the buffer to disk. Clear buffer Empties the buffer. Print buffer Sends the current contents of the buffer to the printer. Send buf Sends the current contents of the buffer to the modem and filters linefeeds and/or carriage returns according to the setting in Edit Buffer. Bufsize You can edit this field if the buffer is NOT installed to change the size of the buffer. To change the buffer size, you must not have a buffer installed. Delay This specifies the time (in 1/200 second units) that Send Buf (and send block from the buffer editor) waits between characters while sending data. FreeMem This is not an option but rather a window that tells you how much free memory you have. Used This also not selectable, but tells you how many bytes have been added to the buffer. Type Ahead This activates the type ahead buffer. The buffer can contain up to 512 ASCII characters and control characters. The Keypad Enter will insert <CR> (and <LF> if NewLine/Line Feed is on), the [HELP] key transmits the buffer contents without a <CR> and the optional <LF>, [F10] will insert a one second pause (this also works for the various other editing fields that output to the modem), Up arrow moves to the beginning, and the down arrow moves to the end. Edit Buffer This option switches to the edit buffer screen. ALT-V also activates this. Keys: [ESC] - Quits Edit Buffer mode, [HELP] - types an escape character. [UP/DOWN/LEFT/RIGHT ARROW] - Moves cursor, Shift-Up - Pages Up, and Shift-Down - Pages Down ^A=Redraw screen ^T=Top of buffer ^F=Bottom of buffer Blocks: ^B=Begin ^E=End ^U=Hide ^S=Transmit ^P=Print ^D=Delete Filters: ^R=Return ^L=Line Feed IMPORTANT: These functions filter Returns and Linefeeds out the selection to transmit in the editor and ALSO from the complete buffer contents send from the terminal screen. At the request of one of my betatesters who wanted to manually enter ANSI escape sequences into the buffer editor, I have made the HELP key type an escape character into the buffer. HELP menu This menu has no selections. It gives an abridged list of the dialer options and short-cut key combinations. Special key combinations available: F1 to F3 Send macros corresponding to the current dialer slot selections. F5 Resets printing colors to white text, black background, no blink, not bold, etc. for all characters received after this is selected, until an ANSI escape sequence is received that changes the colors. F6 Prints the contents of the screen to the printer. If the printer is off-line, you will hear a bell ring. This does not print a bit-map of the screen, but rather the actual letters. Bold is emphasized (bold), and blinking is italicized. Drop-down menus will not be printed even if they are down when F6 is pressed. F7 Capture screen contents to the buffer F8 or Alt-H Causes the modem to drop carrier. F10 Inserts a one second pause into an editing field. Alt-D Download Alt-U Upload Alt-C Capture Alt-T Send Buffer Alt-S Suspend Send Alt-Y Type-ahead Alt-V Edit Buffer UNDO Quit ANSITERM Alt-M Edit Global Macros HELP (see Type Ahead buffer) Clr/Home Clears the Type-Ahead Buffer COLR menu There are 4 selectable color palettes. Palette #1 is the default, unless you save the dialer file while another palette is enabled. Other A yellow "C" on a red background will appear in the upper right corner if CAPS LOCK is on. Acknowledgments I would like to thank the following people for testing ANSITerm for me: Sean Dougherty (another member of Two Worlds Software) B.J. McKinney (SysOp of The Flea Infested BBS -- (813)989-8564) Clifton Mothershed Conan Ford (In Canada!) And we can't forget plaudits to Alan Hamilton for his XYZ file transfer utility. Be sure to register this too! The official TWS support BBS Excalibur II BBS -- (813)988-2603 SysOp: Aaron Oneal